home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / bnchutil.arc / LOCATE.DOC < prev    next >
Text File  |  1991-04-30  |  2KB  |  39 lines
  1.  
  2. LOCATE                                  Steven Holzner
  3.  
  4. Purpose:  Searches all files in the current and the root directories
  5.           of a drive for all occurrences of any specified sequence (e.g., a
  6.           word or phrase) of up to 20 ASCII characters.  Additional search
  7.           paths and/or drives may be specified by using Option 1.
  8.  
  9. Format:   LOCATE searchstring
  10.  
  11. Remarks:  In addition to returning the path(s) and filename(s) of the
  12.           file(s) in which the requested string is found, LOCATE puts
  13.           searchstring into a context of up to 20 immediately surrounding
  14.           characters.
  15.  
  16.           LOCATE.COM is case sensitive;  the string to be found must be typed
  17.           exactly.  The program does, however, strip "high-order" (non-ASCII)
  18.           bits from searchstring, so it can be used, for example with WordStar
  19.           document files.
  20.  
  21.           Normally, if LOCATE does not find the requested string either in the
  22.           current directory or in the disk's root directory, it simply exits.
  23.           It does not automatically search every subdirectory on every drive.
  24.  
  25.           You can extend the search range, however, by preparing a simple ASCII
  26.           file that specifies additional paths and/or drives.  The name of this
  27.           file must be PATH.DAT, and it must be located in the root directory
  28.           (usually C:\ for hard disks, A:\ for floppies).  An example of such a
  29.           PATH.DAT file would be
  30.  
  31.           \WORK
  32.           \LEVEL1
  33.           \A:
  34.  
  35.           Each line in the PATH.DAT file must end with a carriage return and
  36.           specifies an additional path (or drive) for LOCATE to check before it
  37.           exits.  The PATH.DAT file can be up to 300 bytes in length, and
  38.           incorrectly specified entries are ignored.
  39.